

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>3.1.7.1. Plain Pattern &mdash; OpenSees Documentation  documentation</title>
  

  
  
  
  

  
  <script type="text/javascript" src="../../../_static/js/modernizr.min.js"></script>
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../../../" src="../../../_static/documentation_options.js"></script>
        <script type="text/javascript" src="../../../_static/jquery.js"></script>
        <script type="text/javascript" src="../../../_static/underscore.js"></script>
        <script type="text/javascript" src="../../../_static/doctools.js"></script>
        <script type="text/javascript" src="../../../_static/language_data.js"></script>
        <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
    
    <script type="text/javascript" src="../../../_static/js/theme.js"></script>

    

  
  <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="../../../_static/css/custom.css" type="text/css" />
    <link rel="index" title="Index" href="../../../genindex.html" />
    <link rel="search" title="Search" href="../../../search.html" />
    <link rel="next" title="3.1.7.1.1. load Command" href="load.html" />
    <link rel="prev" title="3.1.7. Pattern Command" href="pattern.html" /> 
</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
          

          
            <a href="../../../index.html">
          

          
            
            <img src="../../../_static/OpenSeesLogo.png" class="logo" alt="Logo"/>
          
          </a>

          
            
            
          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <p class="caption"><span class="caption-text">Applications for Users</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../interpreters.html">1. OpenSees Interpreters</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../install.html">2. Installation</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../userManual.html">3. Command Manual</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="../modelCommands.html">3.1. Modelling Commands</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="model.html">3.1.1. Model Command</a></li>
<li class="toctree-l3"><a class="reference internal" href="node.html">3.1.2. Node Command</a></li>
<li class="toctree-l3"><a class="reference internal" href="element.html">3.1.3. Element Command</a></li>
<li class="toctree-l3"><a class="reference internal" href="spConstraints.html">3.1.4. SP_Constraint Commands</a></li>
<li class="toctree-l3"><a class="reference internal" href="mpConstraints.html">3.1.5. MP_Constraint Commands</a></li>
<li class="toctree-l3"><a class="reference internal" href="timeSeries.html">3.1.6. Time Series Command</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="pattern.html">3.1.7. Pattern Command</a><ul class="current">
<li class="toctree-l4 current"><a class="current reference internal" href="#">3.1.7.1. Plain Pattern</a></li>
<li class="toctree-l4"><a class="reference internal" href="uniformExcitationPattern.html">3.1.7.2. Uniform Excitation</a></li>
<li class="toctree-l4"><a class="reference internal" href="multiSupportPattern.html">3.1.7.3. Multisupport Excitation</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../analysisCommands.html">3.2. Analysis Commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="../outputCommands.html">3.3. Output Commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="../materialCommands.html">3.4. Material Commands</a></li>
<li class="toctree-l2"><a class="reference internal" href="../miscCommands.html">3.5. Misc. Commands</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../userExamples.html">4. Examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../messageBoard.html">5. Questions, Bugs &amp; Feauture Requests</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/license.html">6. Copyright and License</a></li>
</ul>
<p class="caption"><span class="caption-text">Framework for Developer</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/sourceCode.html">1. Source Code</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/build.html">2. Building Application</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/references.html">3. References</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/extend.html">4. Extending Application</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/contribute.html">5. Contributing Code</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../developer/issues.html">6. Issues</a></li>
</ul>

            
          
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../../../index.html">OpenSees Documentation</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="../../../index.html">Docs</a> &raquo;</li>
        
          <li><a href="../../userManual.html"><span class="section-number">3. </span>Command Manual</a> &raquo;</li>
        
          <li><a href="../modelCommands.html"><span class="section-number">3.1. </span>Modelling Commands</a> &raquo;</li>
        
          <li><a href="pattern.html"><span class="section-number">3.1.7. </span>Pattern Command</a> &raquo;</li>
        
      <li><span class="section-number">3.1.7.1. </span>Plain Pattern</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
            <a href="../../../_sources/user/manual/model/plainPattern.rst.txt" rel="nofollow"> View page source</a>
          
        
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="plain-pattern">
<span id="plainpattern"></span><h1><span class="section-number">3.1.7.1. </span>Plain Pattern<a class="headerlink" href="#plain-pattern" title="Permalink to this headline">¶</a></h1>
<p>This commnand allows the user to construct a LoadPattern object. Each plain load pattern is associated with a TimeSeries object and can contain multiple NodalLoads, ElementalLoads and SP_Constraint objects.</p>
<dl class="function">
<dt>
<code class="sig-name descname">pattern Plain $patternTag $tsTag &lt;-fact $cFactor&gt; {load commands}</code></dt>
<dd></dd></dl>

<table class="colwidths-given docutils align-default">
<colgroup>
<col style="width: 17%" />
<col style="width: 17%" />
<col style="width: 67%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Argument</p></th>
<th class="head"><p>Type</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>$patternTag</p></td>
<td><p><em>integer</em></p></td>
<td><p>unique tag among load patterns</p></td>
</tr>
<tr class="row-odd"><td><p>$tsTag</p></td>
<td><p><em>integer</em></p></td>
<td><p>the tag of the time series to be used in the load pattern</p></td>
</tr>
<tr class="row-even"><td><p>$cFactor</p></td>
<td><p><em>float</em></p></td>
<td><p>constant factor (optional: default=1.0)</p></td>
</tr>
</tbody>
</table>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="load.html">3.1.7.1.1. load Command</a></li>
<li class="toctree-l1"><a class="reference internal" href="eleLoad.html">3.1.7.1.2. eleLoad Command</a></li>
<li class="toctree-l1"><a class="reference internal" href="sp.html">3.1.7.1.3. sp Command</a></li>
</ul>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The loads (element, nodal, constraints) in a Plain Load pattern are <strong>reference</strong> loads. The actual load applied to a node or element is the product of the <strong>$cFactor</strong>, the reference load, and a <strong>load factor</strong>. The <strong>load factor</strong>, which is obtained from the associated <a class="reference internal" href="timeSeries.html#timeseries"><span class="std std-ref">Time Series Command</span></a> is a function of the <strong>time</strong> in the domain and the time series object.</p>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>Tcl and Python differ here. In the Tcl interpreter the commands to create loads and constraints come in the squirly braces after the command. In python, any load or constraints defined after a pattern are added to that pattern. This is as shown in following example.</p>
</div>
<div class="admonition-example admonition">
<p class="admonition-title">Example:</p>
<p>The following example demonstrates how to create a <strong>Linear</strong> time series, and asociate it with a <strong>Plain</strong> load pattern which contains <strong>nodal loads</strong> to be applied to nodes <strong>3</strong> and <strong>4</strong> of reference magnitude <strong>(0,-50)</strong> and <strong>(50.0, -100)</strong> respectivily.</p>
<ol class="arabic simple">
<li><p><strong>Tcl Code</strong></p></li>
</ol>
<div class="highlight-tcl notranslate"><div class="highlight"><pre><span></span><span class="nv">timeSeries</span> Linear <span class="mi">2</span>
<span class="nv">pattern</span> Plain <span class="mi">1</span> <span class="mi">2</span> <span class="k">{</span>
        <span class="nb">load</span>  <span class="mi">3</span>   <span class="mf">0.0</span>  <span class="o">-</span><span class="mf">50.0</span>  <span class="mf">0.0</span>
        <span class="nb">load</span>  <span class="mi">4</span>   <span class="mf">50.0</span>  <span class="o">-</span><span class="mf">100.0</span> <span class="mf">0.0</span>
<span class="k">}</span>
</pre></div>
</div>
<ol class="arabic simple" start="2">
<li><p><strong>Python Code</strong></p></li>
</ol>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">timeSeries</span><span class="p">(</span><span class="s2">&quot;Linear&quot;</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
<span class="n">pattern</span><span class="p">(</span><span class="s2">&quot;Plain&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
<span class="n">load</span><span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="o">-</span><span class="mf">50.0</span><span class="p">)</span>
<span class="n">load</span><span class="p">(</span><span class="mi">4</span><span class="p">,</span> <span class="mf">50.0</span><span class="p">,</span> <span class="o">-</span><span class="mf">100.0</span><span class="p">)</span>
</pre></div>
</div>
</div>
<p>Code Developed by: <strong>fmk</strong></p>
</div>


           </div>
           
          </div>
          <footer>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2020, The Regents of the University of California

    </p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  


  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
    <!-- Theme Analytics -->
    <script>
    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

    ga('create', 'UA-2431545-1', 'auto');
    ga('send', 'pageview');
    </script>

    
    

  <style>
         .wy-nav-content { max-width: none; }
  </style>



</body>
</html>